home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / inet_tcp / _winfile / bpq408a / bpqcode.doc < prev    next >
Encoding:
Text File  |  1994-10-01  |  7.0 KB  |  231 lines
  1.         The G8BPQ AX25 Networking Package.
  2.  
  3.  
  4. 1. Introduction.
  5.  
  6. This software allows an IBM PC, or similar machine, equiped with suitable
  7. Communications hardware, to act as a Node in a NET/ROM compatible AX25 
  8. network, and/or to support a multiuser Mailbox, or other similar applications.
  9.  
  10. The switch section of the code supports up to 16 AX25 ports, and the
  11. application interface supports up to 64 connections. The basic applications
  12. interface is called 'BPQ Host Mode', and is defined in file BPQHOST.DOC.
  13. Additional drivers are provided to convert this to other common Amateur
  14. interface standards (eg TNC2 via COMBIOS, and WA8DED Host Mode).
  15.  
  16.  
  17. Note the software is NOT Public Domain. It may be used only by licenced
  18. Radio Amateurs in Amateur Packet Radio systems.
  19.  
  20.  
  21.  
  22. 2 Hardware Requirements.
  23.  
  24. The system is written in 8086 assembler, and is currently only available for
  25. the MSDOS/PCDOS environment, although once loaded it makes no use of operating
  26. system facilities. It has been tested on IBM PC and XT machines, and a number
  27. of similar machines. (AST Premium, Toshiba T1100+, OPUS). The software needs
  28. about 48 - 80k RAM, varying with number of buffers, comms links and COMBIOS
  29. ports configured.
  30.  
  31. The software supports the following comms hardware:
  32.  
  33.     PAC-COM  PC120 card
  34.     DRSI PCPA card
  35.     Software Forge HDLC card for the Toshiba T1100 (with external modem).
  36.     KISS mode TNC via a standard PC ASYNC card or QUADRAM Quadport .
  37.     Link to NET/ROM or TheNet Async port.
  38.     RLC100 4 port HDLC card.
  39.     Baycom USCC 4 port HDCL card. 
  40.  
  41. A version is also available for the Kantronics Data Engine.
  42.  
  43.  
  44.  
  45. 3. Networking Facilities.
  46.  
  47. The system is designed to be operationally compatible with existing NET/ROM
  48. or TheNet nodes, but there are a few minor differences. As it can support
  49. an integrated BBS, it has 2 Callsign/Alias pairs, one for accessing the node,
  50. and the other the BBS. Note, however, that a multiport node does not need a
  51. different callsign for each port. Because of the multiport support, the 
  52. 'Downlink' connect command needs a port number as the first parameter (eg
  53. C 2 G8BPQ). A connect to another Node doesnt need this - the system selects
  54. the 'best' port as found from the NODEs and ROUTEs lists.
  55.  
  56. Although multiple applications are allowed, only one (BBS) has its own
  57. Callsign/Alias pair. Others are accessed by connecting to the switch, then
  58. entering the service name.
  59.  
  60. There are  extra commands for normal use (BBS, or other application name, to
  61. connect to the applications, and PORTS to display available port descriptions),
  62. and 2 commands intended primarily for the system operator (STATS and LINKS).
  63.  
  64. Two extra commands PACLEN and L4T1 are available to set Paclen for NODE
  65. generated messages (nodes lists, etc), and the Transport timeout. At the
  66. moment these are primarily for me to experiment with, but feel free to fiddle.
  67.  
  68.  
  69. The system is also able to link to the 'back end' async port on a normal
  70. NET/ROM or TheNet node.
  71.  
  72.  
  73.  
  74. 4 Getting Started.
  75.  
  76.  
  77.  
  78. A. Decide what you want.
  79.  
  80.  
  81. The software can be configured as a mailbox access system, a packet switching
  82. node, or a combination of both. I would expect most intallations to use either
  83. one or the other, but if you run a well sited BBS (particularly if multiband),
  84. and there is a shortage of nodes in your area, you may wish to run both.
  85.  
  86.  
  87. B« Choosσ you≥ hardwarσ anΣ software.
  88.  
  89.  
  90. You need an IBM PC/XT/AT or compatible. A switch needs very little RAM (
  91. about 128k), but a BBS system will probably need a minimum of 640K. You can
  92. connect your radios via an internal packet adaptor (PC120 from PACCOM, 
  93. PCPA from DRSI, etc), or via normal TNC's running in KISS mode (or both). For
  94. a new installation I recommend the internal card, as it will normally be 
  95. cheaper (especially for multiport nodes), and faster, but if you already have
  96. a TNC which has (or can be fitted with) a KISS option, then by all means use 
  97. it.
  98.  
  99. The software has been tested with the BBS systems written by W0RLI, F6FBB,
  100. G1NNA, and G4YFB, and with AK1A's PacketCluster. It is likely to work with
  101. other system which use a similar interface - if in doublt, consult the 
  102. author of the program concerned.
  103.  
  104.  
  105. C. Edit the configuration file (BPQCFG.TXT)
  106.  
  107.  
  108. I hope the comments in the file make it largely self-documenting. You need
  109. one Callsign/Alias pair for BBS access, and one for the Node. If you are
  110. running both, they must be different, but if you are running only one or
  111. the other, you must still put BOTH entries in the file, but they MUST be the
  112. SAME. The software doesn't currently verify this, so be careful!
  113.  
  114.  
  115. Most of the configuration params can be left alone - the ones to look at
  116. are:
  117.  
  118. IDMSG and INFOMSG
  119.  
  120. BBS, NODE    to select BBS support and NODE support as required 
  121.  
  122. ROUTES        to 'Lock In' the routes you want to use
  123.  
  124.  
  125. Note that the supplied Networking parameter conform (more or less) to the
  126. recommendations made at SYSOPS 5.
  127.  
  128.  
  129.  
  130. There are sample 'PORTS' configuration files for the various link types 
  131. supported in file PORTS.DOC - copy and customise the ones you want to use.
  132.  
  133.  
  134.  
  135. D. Run BPQCFG.
  136.  
  137.  
  138. This will convert the configuration file to a format suitable for use by the
  139. main software. Validation isn't wonderful, but it may produce error messages.
  140.  
  141.  
  142.  
  143. E. Load it.
  144.  
  145.  
  146. I suggest you test the system first using a simple terminal program, before
  147. trying it with the BBS (if required).  I have included on the disk a suitable
  148. terminal program (PAC4), which may be used with the system.
  149.  
  150.  
  151. When running with a multitasker (eq DesqView), you must load my software
  152. before the multitasker. You should run BPQCODE, then any required interface
  153. drivers. The available drivers are described in DRIVERS.DOC, but for initial
  154. testing, just run BPQHTNC2. A copy of my AUTOEXEC.BAT file follows (I use
  155. W0RLI BBS). Once the switch is running, load Desqview (if required), then
  156. your BBS or other application programs.
  157.  
  158.  
  159. My AUTOEXEC.BAT:
  160.  
  161. cd \bbs
  162. LM
  163. SHARE
  164. cd \net
  165. bpqcode
  166. bpqhtnc2 
  167. cd \bbs
  168. mbinit
  169. cd \dv
  170. dv
  171.  
  172. The BBS software is loaded by a Desqview script file. The following saves
  173. the ROUTES and NODES to disk before shutting down.
  174.  
  175. cd \net
  176. bpqnodes
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184. Appendix 1 - Fowarding files
  185.  
  186. Both MBL and RLI BBS software requires that the reply to the first connect in
  187. a forward file connect sequence is of the form *** CONNECTED to xxxx. This is
  188. not normally provided by the switch code, as the first connect is effectively
  189. at the Net/Rom level. To get round this, I have provided a dummy command, 
  190. C SWITCH, which returns the string '*** CONNECTED to SWITCH'. This should be
  191. included as the first entry in each set of forwarding commands. See below
  192. for sample forwarding files for MBL and RLI.
  193.  
  194. MBL:
  195.  
  196. FA GB7NTS
  197. 00-23
  198. @SWITCH
  199. .C LRG7 
  200. ?u
  201. +to
  202. .c GB7NTS-7
  203. +to
  204. ?u
  205. G4MTP
  206. GB7NTS
  207. -----
  208.  
  209. RLI:
  210.  
  211. CC SWITCH
  212. NC GB7NTS
  213. HB0023GB7NTS
  214. GB7NTS
  215. _271
  216. _1111
  217. *** EOF
  218.  
  219.  
  220.  
  221. John Wiseman, G8BPQ
  222. 76,Haywood Road,
  223. Mapperley,
  224. Nottingham.
  225. NG3 6AE.
  226.  
  227. Phone 0115 9522669    (Please phone only between 20:00 - 22:00 UTC)
  228.  
  229. 1 October August 1994.
  230.  
  231.